-= Old School Library (OSLib) Sprites Lib =-
  NEO Spring Coding Competition 2007
  by phosphorous (ceriumz@hotmail.com)


= Introduction =

OSLib is a C library that greatly simplifies coding games and apps on the PSP.
It took second place in the NEO Spring Compo 2006. This library builds on top
of OSLib to make animated sprites as easy as everything else in OSLib.

The eboot demonstrates all of the features including:

- Create an animated sprite with only an image, height, and width
- Animation plays and loops automatically
- Control the animation framerate
- Functions to play and stop animation
- Ability to reverse animation
- Animation can be flipped vertically or horizontally
- Set start and end frames of animation
- Jump to a specific frame
- Create multiple sprites from one sprite sheet
- Create different sized sprites from one sprite sheet



= Installation =

1.5: Copy the two directories in the 1.5 directory to PSP/GAME
1.0: Copy the directory in the 1.0 directory to PSP/GAME.
     Copy all the image assets under 1.5 to the directory you just move


= Creating spritesheets from animated GIFs =

Download ImageMagick from http://www.imagemagick.org/script/download.php
Install ImageMagick and open the command line tool.

Run the following commands:

  convert +adjoin -coalesce animated.gif frame%02d.gif
  montage frame0[0-9].gif -tile x1 -geometry +0+0 tile.gif

The first command saves the individual frames of your animated gif.
The second command puts the frames back together as a spritesheet.
See http://www.imagemagick.org/Usage/montage/ for more info.



= Thanks =

Brunni for OSLib!
Ren "Foxx" Ramos for Sonic Battle rips.
Anonymous for Metal Slug rips.
Lumo for alpha sprite. http://www.go2lumo.com/?action=fonts
